<h2>Vorlagenerweiterung</h2>

<h3>Sinn und Zweck</h3>
<p>
 Sie können das Erscheinungsbild Ihrer Piwigo-Galerie im Einzelnen verändern, 
 indem Sie vorhandene Vorlagendateien gegen von Ihnen angepasste austauschen.
 So können Sie z.B. die vorgegebene Vorlagendatei header.tpl, die für die
 Darstellung des Seitenkopfes Ihrer Galerie verantwortlich ist, durch eine
 von Ihnen angepasste Version my_header.tpl ersetzen. Wurde der Datenbank
 der Austausch bekannt gemacht, wird Ihr Seitenkopf an Stelle 
 des originalen Seitenkopfes in Ihrer Galerie angezeigt.</p>
<p>
 Die Erweiterung von Vorlagen ist ein mächtiges Werkzeug, das es Einsteigern 
 und erfahrenen Anwendern ermöglicht, eigene, angepasste Vorlagen zu erstellen.
</p>

<h3>Originalvorlagen</h3>
<p>
 Ein Thema umfasst ein Reihe von Vorlagendateien, die die Galerie-Seiten bilden.
 Diese Dateien sind die Orginalvorlagen.
</p>

<h3>Optionale URL-Schlüsselwörter</h3>
<p>
 In die URL der Galerie können Schlüsselwörter oder aktive Permalinks (siehe die
 Hilfe zu Permalinks) nach dem Modulnamen eingetragen werden.<br>
 <a href="#warnings">Achtung:</a> Wenn die gleiche Originalvorlage
 und das gleiche Schlüsselwort für mehr als eine angepasste Vorlage 
 gebraucht werden, wird nur das letzte Schlüsselwort berücksichtigt.
</p>

<h3>Verbundenes Thema</h3>
<p>
 Ein verbundenes Thema ist ein Thema, aus dem Vorlagendateien ersetzt werden.
</p>

<h3>Wo sind die Originalvorlagen gespeichert?</h3>
<p>
 Die zu jedem Thema gehörenden Originalvorlagen finden sich im Verzeichnis
 <em>/themes/default/template/</em>. Die Originalvorlagen dort
 sollten nicht verändert werden, da Änderungen bei späteren Updates
 verloren gehen.<br>
 Zu den aktuell unterstützten Originalvorlagen gehören:
</p>
<ul>
  <li><span class="filename">index.tpl</span></li>
  <li><span class="filename">mainpage_categories.tpl</span> und/oder <span class="filename">thumbnails.tpl</span></li>
  <li><span class="filename">menubar.tpl</span></li>
  <li><span class="filename">header.tpl</span> und/oder <span class="filename">footer.tpl</span></li>
  <li><span class="filename">picture_content.tpl</span> und/oder <span class="filename">picture.tpl</span></li>
  <!-- <li><span class="filename">slideshow.tpl</span></li> -->
  <li><span class="filename">profile.tpl</span> und/oder <span class="filename">profile_content.tpl</span></li>
  <li><span class="filename">tags.tpl</span></li>
  <li><span class="filename">upload.tpl</span></li>
  <li><span class="filename">about.tpl</span></li>
  <li><span class="filename">popuphelp.tpl</span></li>
  <li><span class="filename">search.tpl</span> und/oder <span class="filename">search_rules.tpl</span></li>
  <li><span class="filename">nbm.tpl</span> und/oder <span class="filename">notification.tpl</span></li>
  <li><span class="filename">identification.tpl</span> und/oder <span class="filename">register.tpl</span></li>
  <li><span class="filename">redirect.tpl</span></li>
</ul>

<h3>Angepasste Vorlagen abspeichern</h3>
<p>
 Angepasste Vorlagen sollten im Verzeichnis template-extension oder in einem Unterverzeichnis
 dieses Verzeichnisses abgespeichert werden (z.B. <em>/template-extension/my-default/header.tpl</em>
 oder <em>/template-extension/my-theme-name/header.tpl</em>). 
 Der Name einer Vorlagendatei ist frei wählbar, die Dateiendung .tpl muss allerdings angefügt werden.
 <!--***-->
 The template files in subfolders appear in the Template configuration screen as available custom templates.
</p>

<h3>Angepasste Vorlagen aktivieren</h3>
<p>
 Wählen Sie die zu ersetzende Originalvorlage aus. Sie können auch ein URL-Schlüsselwort benutzen,
 um sicher zu stellen, dass die angepasste Vorlage nur auf den Seiten mit dem gleichen Schlüsselwort
 angezeigt wird. Wählen Sie das verbundene Thema aus, auf das sich die Anpassungen auswirken sollen.
 Teilen Sie der Datenbank die Veränderungen mit.
</p>

<h3>Angepasste Vorlagen deaktivieren</h3>
<p>
 Deselektieren Sie die Originalvorlage und teilen Sie der Datenbank die Veränderungen mit.<br>
 Entfernen Sie die angepassten Vorlagen aus dem Verzeichnis template-extensions.
</p>

<h3>Warnhinweise</h3>
<ul>
 <li>
  Die <strong>Originalvorlage</strong> muss wirklich die Originalvorlage sein, sonst kann
  es zu unvorhersehbaren Ergebnissen kommen.
 </li>
 <li>
  Wenn die gleiche Originalvorlage und das gleiche Schlüsselwort 
  für mehr als eine angepasste Vorlage gebraucht werden, 
  wird nur das letzte Schlüsselwort berücksichtigt.
 </li>
 <li>
  Mitgelieferte Beispielvorlagen sind nur für Testzwecke bestimmt und 
  sollten nicht verändert werden. Erstellen Sie Ihre eigenen Vorlagen
  oder kopieren Sie vorhandene Vorlagendateien in das Verzeichnis
  <em>/template-extension/my-theme/</em>.
 </li>
 <li>
  Unmittelbar nach dem Löschen einer angepassten Vorlage wird die
  Originalvorlage reaktiviert.
 </li>
</ul>

